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START UP 



Ed i tor /AsftMblcr /Debug (EASHD) 

FOR START UP: 



Put the 088 diskette in disk drive 1 end turn on the power. 



This Mill loed the Operating Sgstea end execute OS/A-*>. Now enter: 

EASHO (return) 

This will loed the Editor/Assembler/Debug end start executing it. 
See the OS/A-*- Mnual for other capabilities. 



UARNSTART: 



The user can return to 08/A* using the EASMD comnand CP or bg using 
the SYSTEM RESET keg. He can then re-enter EASMD bg using the OS/A-t- 
comeand RUN (if he has not loaded another program). This does a 
warn start which preserves text lines alreadg in memorg. 



BACK-UP COPY: 

On a dual drive sgstemi siaplg use COPY or DUPD8K. On a single 
drive sgsteA< one can use DUPDSK or one can make a back-up copg 
of EASMD on another diskette via the (3S/A+ SAVE command. 

Sgstem RAM size 32k 40k 48k 

Start address 5700 7700 9700 

End address 7C00 9C00 BCOO 

File Name: EASMD.COM (or ang .COM name of gour choice) 



NOTE: For a full explanation of OS/A+ commands see the OS/A+ 
reference manual. 



SYNTAX CONVENTIONS 



The following convontions *r« u«od in the discussion of 
syntax in this Mnu«l. 

1) Capital lottors donoto cooMMnds* otc. which «ust 
bo tvpod bv tho usor oxactly as shown. 

(og. LIST. DEL) 

2) Lowor caso lattors donoto types of items which 
My be used. The various types are shown in the 
next section, (eg. lno> 

3) Items in siiuare brackets are optional (eq. Cflnol) 

4) Multiple items in braces indicate that any one may 
be used. (eg. <A> ) 

TYPES OF ITEMS: 

The following types of items are used in describing syntax 
comeuinds. 

Ino line number (in range to 65939). 

string A string of ASCII characters. 

adr A memory address (given in hex). 

data A list of hexadecimal values separated by 
coflMsas. 



Example: AB<12«FE 
incr Increment a decimal value. 

filespec See Atari DOS manual or OS/A-»- reference 
manual for full format. 
Generally you may use 

DCn3: xxxxxxxx. yyy for disk files 
P: for the printer 

etc. 

Note that in EASMD filespecs must 
ALWAYS be prefaced with a pound sign (tt). 
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EDITOR 



Th« Editor allows tho usor to ontor «nd odit linos o-f ASCII 

tOKt. 



TEXT FORMAT 



Linos of ASCII toxt rocoivod by tho Editor are storod in 
MOflioru. A lino consists of a lino nu«bor (0 to 69939). 
toxt inforaiation and a carriage return. Tho toxt information 
that is botMoon tho lino nunber and the carriage return is 
storod exactly as it is received. Thus any combination of 
ASCII data is valid toxt. 

Example: lOOOLITTLE GREEN APPLES 

This is valid text as far as tho Editor is concerned. 



NOTE: Tho Assembler, houiever. expects a blank after 
tho lino number and will not look at the first 
character after the lino number. Thus 

lOOOABC LOA ttO 

is seen as 

1000 BC LDA to 

Example: 100 PRINT X<SIN(X) 



TABLES 



Tho Editor can bo used to create and edit Basic 
programs. 



The text area and other user tables are built starting at an 
address in low memory and growing towards high memory. The user 
can change this address using the LOMEM command. 

The user can also change the highest address the Editor will use 
for user text by using the change memory command in the Debug 
monitor to change UHIMEM. (See memory map for UHIMEM address). 

COnnAND FORMAT 



The stored lines of toxt are manipulated by Editor commands. A 
command is distinguished from toxt by the absence of a line number. 
Any lino of data received by the program that does not begin 
with an ASCII numeric is considered to be a command. The 
Editor will examine tho characters to determine what function 
to perform. If those characters do not form a valid command, 
or if the command syntax is invalid, the Editor will respond 
with: 

WHAT? 
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LINE PROHPTING 



Th« Editor will proaipt th« u««r each tioia a cooMiiand has finished 
•xacuting by printing: 

EDIT 

The cursor will appear on the following lino. Since so«c 
coMMnds take awhile to execute< the prompt serves to tell 
the user when nore input is allowed. 
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EDITOR COmND SYNTAX AND DECRIPTION 



NEW 

HEU will d«l«t« all usar text from the text mtw in 
•••or V . 

DEI. Ino 

DEL lnol> lno2 

DEL dalfftet tha specified line number (Ino) or all the 
lines in the range Inol through lno2. 

FIND /string/ 

FIND /string/, A 

FIND /string/lnoiC# lno23 

FIND /string/lnolC. lno23. A 

The FIND coMnand will search the specified lines (all 
or Inol through lno2> for the "string" between the 
specified deliniters. The delimiters may be any 
character other than blank. The second delimiter must 
be the same as the first. 

If "A" is specified. an<j line that contains a matching 
string will be printed at the user terminal. If "A" is 
not specified, then onl^ the first line that contains a 
matching string will be printed. 

LIST 

LIST Cfilespec 

LIST lnolCilno23 

LIST ttf ilespec. InolC, lno23 

The LIST command will cause all lines in the specified 
range to be listed to the screen (or to a device/file 
when "ttf ilespeC is specified). 

If "Inol" is less than the line number of the first 
text line* then listing will start with the first line. 
If "lno2" is greater than the line number of the last 
text line* then listing will end with the last line. 

Hitting the break key will stop the LIST. 

Example: LIST •D1:EX. TST 

Will list all lines to a file EX. TST 
on drive 1. 

Example: LIST ftP: 

Will list to the printer. 
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PRINT 

PRINT •filvspvc 

PRINT InolC.lno23 

PRINT ilc«p»c. InolC. lno23 

Print is ciactlu the sam« as LIST sxccpt that thd line 
numbers «r« not PRINT«d< and that tha EDIT raady protspt 
will not bo printad aftar tha last lina until tha usar 
hits tha RETURN kay. 

ENTER »f ilaspacC.M3 

Tha ENTER coMiand causas praviously LISTad taxt from the 
davica or fila spacifiad by #filaspac to ba ra-antarad. 
Tha optional "H" paranatar spacifias that tha nam text 
is to ba aargad with tha taxt currently in fflemory. If 
"H" is not prasantt than tha text area will be cleared 
before starting the ENTER. 

Example: ENTER •D2: XXX 

Will re-enter the text that was listed to 
the file XXX on drive 2. 

NUN 

NUn slnOf incr 
NUM incr 

The number command is used to automatically attach line 
numbers to user lines. The user is prompted with the 
next line number. A blank automatically follows the 
line number. The "slno" parameter specifies the starting 
lina number. The "incr" parameter is the line number 
increment. 

The default "incr" is 10. The default "slno" is the last 
taxt line number plus "incr". 

Hitting RETURN after the line number prompt terminates 
NUHbcr mode. 

REN 

REN slnot incr 

REN incr 

The REN command renumbers the text. The first line 
number will be "slno". The line numbers will increment by 
incr. The default "slno" and "incr" is 10. 

REP /old string/new string/ 

REP /old string/new string/. -CA) 

<Q> 

REP /old string/naw string/lnolC« lno23 

REP /old string/naw string/lnolC« lon23« <A> 

<Q> 

Tha REP command will search tha specified lines (all 
or Inol through lno2> for tha "old string" (between 
specified delimiters). Tha delimiters follow the same 
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rulffs «s th« d«li«iit«rs for FIND. 

Th« "A" option c«usos mil occurronco of "old string" to 
bo roplacod with "now string" (botwoon tho t«mo specified 
d«li«it«rs>. 

If tho "Q" option is specified then when each Mtch is 
foundi the line is listed and the user is allowed to 
specify change (Y followed by RETURN) or don't change 
(RETURN alone) this occurrence. Hitting BREAK will 
terminate the REPlace and return to the Editor. 

If neither "A" or "Q" is specified* only the first occur- 
rence of "old string" will be replaced with "new string". 

NOTE: Each tine a replace is done the changed line is 
listed. 

SIZE 

The SIZE cofMsand prints the users low fltemory address* the 
highest used Aeeiory address* and the highest usable 
meiBory address (UHIMEM). 



LOHEM adr 

LOMEM comnand changes the address at which user tables 
start. 

NOTE: The LOMEM command will destroy any user statements 
in memory. 

NOTE: This command can be used to reserve a space 

between the default low memory and the new low 
memory address. This space can then be used 
for the object output from the assembler. 

CP 
DOS 

CP or DOS returns to the OSS Control Program (OS/A-f) 

BYE 

BYE returns to the Atari Memo Pad. 



ASM 

ASM Ctffilespecl]* C*f ilespec23. Cttfilespecai 

The ASM command assembles source code and produces object code 
and a listing. 

By default: 

1) The source "device" is the user text area. 

2) The listing "device" is the screen. 

3) The object "device" is memory. 
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Th«s« defaults can ba ovarriddan as follows: 

filaspacl - sourcs coda fila or dtvica 
filaspac2 - listing fila or dtvio 
filaspacS - objact fila or davic* 

A "filaspac" can ba omittad bg substituting a coaima. 
in which casa tha dafault holds for that paraaiatar. 



Exaiiip lo: 



ASM ttDl : SOURCE. #D2: LIST/ »D1 : OBJ 

In this sxamplsi tho source will co«a 

from Dl: SOURCE* the listing will ba 

written to D2: LISTi and the object will 
be written to D1:0BJ. 



Example: 



ASM 



, I ttD3: OBJ 



Exaeip le: 



In this cxaeiple the source will come from 
user text area in memory* the listing will 
go to the screen* and the object code will 
be written to the file OBJ on disk drive 3. 



ASM 



»P: 



In this example the listing will go to 
the printer. 



NOTE: See the . OPT ion directive for full information 
about when object is actually written to the 
specified file (or memory). 



BUG 



The BUO command causes the debug monitor to be entered. 
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DEBUG 



Tb« Debug Monitor allows tho u««r to perform controlled axecution 
of machino code* oxMln* nomoryi altor moiiorv* novo nemory blocks 
and verify the eauality of «e«ory blocks. 

COmAND FORMAT 



The Debug Monitor assusies that any line of data that it receives 
is a coMMnd. If the data does not form a valid command* the 
Debug Monitor responds with: 

WHAT? 

LIVE PRWTING 

The Debug Monitor will signal completion of a command by printing: 

DEBUG 

The cursor will appear on the following line. 

NOTE: If the user is getting a syntax error indication (WHAT?) on 
what he thinks is a valid command* he should check the 
prompt message (DEBUG/EDIT) to verify that he is in the 
correct mode. 

DEBUG CmAND SYNTAX AND DESCRIPTION 

G Cadr3 

The O Command (Go) transfers control to the specified 
address via a JMP command. If "adr" is not specified* 
then the current monitor program counter is used. 

T Cadr3 

The T Command (Trace) causes instructions to be 
executed starting at "adr". If "adr" is not 
specified then the current monitor program 
counter is used. As each instruction is 
executed* its address* mnemonic and operand 
will be displayed along with the current values 
in the 6902 A. X. Y* P( status), ti S(stack) registers. 

Hitting the break key (BREAK) will terminate trace. 

8 Cadr3 



The 8 Command (Step) is exactly like the T comeiand 
except that only one instruction is eifecuted. 
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D 
D 



The D coMMnd (Display Mffmory) will caust m«Mnory from 
"adri" to "«dr2'' to b* displaytd in hcxadac imal. If 
"adr2'' is o«itt«d> than 8 byt«s ars displayed 
(i«. adr2 - adrl * Bi. 

If "adrl" is ofliittadi than this display starts wharc 
tha last display laft off (iai at tha last "adr2" -f i). 

Hitting tha braak ksy (BREAK) will terminato Display. 

C Cadrl3<data 

Tha C coflMsand (Changa Memory) is used to altar 

mamory starting at "adr". If "adr" is not 

spacifiadi than Changa uses the most recent "adrl" 

if D was tha last co«mand< or the next unchanged address 

if C was the last command. 

The "data" is a list of 1 byte hex values 

separated by comeias. 

Example: C 900(K3. CD. IF 

Will change locations 5000 thru 5004 
to 3*CD#1F<2. 3 respectively. 

Multiple commas may be used to skip over memory addresses 
without changing the contents to reach the desired address. 

Example: C 5000<3. . IF 

will change hex location 5000 to 3, 
location 5002 to 1F« and location 
9001 will be unchanged. 

L 

L adrlC,adr2] 

The L command (list) will causa the instructions 
located at "adrl" to be disassembled and displayed 
with the address* instruction mnemonic and operand. 
If "adr2" is not specified* then twenty instructions 
will be listed. If the address field ("adrl") is not 
specified, then this list will start where the last 
one laft off. 

Hitting tha break key (BREAK) will stop the listing. 
H tadr<f sadr< f aadr 

Tha M comflMind (Move) moves data from the address "fsadr" 
through tha address "faadr" to the address specified 
with -tadr". 

tadr - "move to" address 

fsadr - "move from" start address 

faadr - "move from" end address 
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V 



«drl<4dr2< adrS 



Th« V CoflMMnd (V«rif«) compares the flicAory starting at 
"adrl" with tha mafliory located at "adr2" through "adr3". 
If any of tha comparad bytas aismatchi than addrass and 
data bytas will ba displayed. 

DR 

Tha DR coflMiand (Display Registers) will causa the Af X< Y< 
status (P) and stack <S) registers to be displayed in 
hexideciflMl. 

CR <data 

The CR CoMNand (Change Registers) is used to change the 

registers. Registers are assuaed to be in the order: 

A«X«Y. status (P) stack (S). so that the first byte of 

data goes into A register the second into X< etc. 

As in the C coflMsandi "data" is a list of hexadecimal values 
separated by coamms and field may be skipped by use of 
multiple commas. 

Example: CR<FF> i 3 

will set A«FF and Y-3. It will leave 
X<P and S unchanged. 

X 

The X command (exit) will cause control to return to 
the Editor. 

A 

The A command (Assemble) will cause the system to enter into the 
Debug Assembler mode. No prompt other than the cursor is used 
in this mode. 

The Debug Assembler is a line-at-a-time assembler that uses 
6902 mnemonics and operand format. Relative branch operands 
are specified as the actual "branch to" addressi the Assembler 
creates the relative addrass. 

The format of each line is: 

Cadr3< assembler code 

Tha Debug Assembler keeps track of the location counter so that 
if "adr" is omitted* the next consecutive address is used. 

Entering only a carriage return will return the user to the 
Debug monitor. 

Example: While in Debug mode the user enters: 
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A 

9000< L0A*3 
< BNE «9010 

Th« "A" puts th« user into the Debug 
Astcnbler. The next two stateeients 
will cause Memory to contain the 
following: 

9000 A9 03 

5002 DO OC 



NOTE: The blank after the is required. 

NOTE: The Debug Assembler accepts both decimal and hex 
numbers as operandsj therefare< hex operands must 
be preceeded by "t". 



BREAK POINTS 



BRK instructions must be individually set and removed by the user. 

Step and Trace intercept the BRK instruction and simulate its 
execution. 
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ASSEMBLER 



Th« AsscMbltr g»t« control uihon ASM is typed into th« Editor. 
For tho ASM comaiand syntax* soo the Editor section. 

Hitting the broak k^^ (BREAK) will stop tho assembly. 

ASSEHBLER INPUT 



Input to the AssMblor is lints of ASCII data as ontcrsd into 
the Editor. Source lines are of the foroi: 

(line number) (blank) (source statement) 

where source statement is of the form: 

Clabel3 {6502 instruction} 

{ directive > 

A source statement may consist of a label only< or it may be 
blank. 

In general the format is as specified in the HQS Technology 
6502 Programming Manual. We recommend that the user unfamiliar 
with 6502 assembly language programming should purchase: 

"Programming the 6502" by Rodney Zaks 

or 

"6502 Assembly Language Programming" by Lance Leventhal. 



INSTRUCTION FORMAT: 



A) Instruction mnemonics as described in the MOS 
Technology 6502 Programming Manual. 

B) Immediate operands begin with # 

C) "(Operand. X)" and " (Operand )# Y" for indirect 
addressing. 

D) "Operand. X" and "Operand. Y" for indexed 
addressing. 

E) Zero page and forward etiuates recognized and 
evaluated within the limits of a two pass 
assemb ler. 

F> "*" refers to the location counter. 

Q) Comment lines begin with "i " 

H) Hex constants begin with 
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I) Th* "A" operand is r«fi«rv«d for accumulator 

addressing. 

DIRECTIVES 



.TITLE "string" 

The .TITLE diroctivc allows the user to specify 
a title to be used in conjunction with . PAGE 

.PACE C"string"3 

The .PAGE directive allows the user to specify 
a page heading. It issues an ASCII foroi feed 
(hex OC) and prints the most recent title 
and page headings. 

NOTE: The «ost recent title and page headings 
are also printed every time 92 lines of source 
code have been assembled. 

.BYTE expression and/or "string" list 

The . BYTE directive sets a one byte value for 
each expression and the ASCII equivalent of 
each character of each string into the object 
code. 

Example: . BYTE 3. "ABC". 7. "X" 

produces: 

03 41 42 43 07 98 

.WORD expresion list 

The .WORD directive sets a two byte value into 
the object code for each expression in the list. 
The value is in 6902 address order (least 
significant byte, most significant byte). 

Example: . M3R0 »1000. «2000 

produces: 

00 10 00 20 

. DBYTE expression list 

The .DBYTE directive sets a two bute value into 
the object code for each expression in the list. 
The value is in most significant* least significant 
byte order. 

Example: . DBYTE « 1000. ^2000 

produces: 
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10 00 20 00 



TAB cxprvstiont •ipr«s«ion« expression 

Th« .TAB directive sets displacements for the 
printing of the op codei operandi and comment 
fields of the source line. Each expression is 
a one byte value. 
Defaults are 12« 17. 27 . 

OPT assembler option list 

The .OPT directive allows the user to specify 
certain options affecting the assembly. 

Possible options are : 

LIST/NOLIST 
NOOBJ/OBJ 
ERR/NOERR 
EJEGT/NOEJECT 

LIST/NOLIST determines if a listing is 

produced. 

NOOBJ/OBJ determines if object code is 

produced. 

ERR/N(^R determines if error messages 

are printed. 

EJECT/NOEJECT determines if a form fecd< titles 

and page are printed after 52 
source lines. 

Defaults are: 

OBJ - Mhen the object is going to a device/file. 
NOOBJ - when the object "device" is memory. 
LIST. ERR. EJECT - in all cases. 

expression 

The *> directive serves the function of ORG. 
It sets the current location counter for 
subse(iuent source statements. 

NOTE: *<■ must be written with no intervening 
blanks. 

■ expression 

The ■ directive is an equate (EQU) statement. 
It must always be written: 

LABEL <B expression 

The value of the "expression" is assigned to 
"LABEL". 
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. IF •iprffstion < l«b«l 

The . IF st«t«fli«nt allows liaitad conditional 
assa«bly. 

If tha "axprasftion" i« trua (non-zaro>« tha Assawblar 
skips all following linas up to tha ona that bagins with 
tha "labal". If tha "axprassion" is falsa (iaro>. 
assambly continuas norMlly. 

NOTE: Thara can ba NO blank batwaan tha coouna and labal. 

. INCLUDE ftf ilaspac 

Tha . INCLUDE diractiva allows sourca coda from the davica 
or fiia spacifiad in "filaspac" to ba insartad into tha 
assaably. 

NOTE: . INCLUDE's can not be nested. That is. a file that 
was included cannot contain a . INCLUDE directive. 

NOTE: . INCLUDE cannot ba tha last statement. It must 
be followed by a .END or soma other statement. 

. END 

The .END directive terminates the assembly. 



EXPRESSIONS 



Expressions are evaluated strictly left to right. Parentheses 
are not valid. Valid operators are: 

- * / & («t is a binary AND) 

These are all binary operands. ("-5 3" is not valid/ but 
"0-5+3- is valid. ) 

Example: LDX * ADDR/256 
LDY • ADDRtc235 

Will put the MSB and LSB portions of the address 
of "ADDR" into X and Y respectively. 



STRINGS: 



strings must be enclosed in double quotes: 

. BYTE -THIS IS A MESSAOE" 

Tha single character representation for tha immediate operand : 

• 'C 
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LABEL: 



Labels Must start in ths 1st column aftar (line numbtr) (blank). 
A labal My consist of up to 299 charactars. It must start 
with an alpha character and nay be followad by alpha-nunar ic 
characters or the character " . 

NOTE: Tha character "A" by itself can not be a label. 



CQHHENTS: 



ConMent lines start mith the character "i" 

No special character is needed to delineate a comment 
after the assember code on a line. When the assembtr 
recognizes the end of the operand field (or op code 
field for instructions without operands)* the rest 
of the line is assumed to be comment. 

NOTE: This can give unexpected results in some cases. 
Example: LDA 7A GET NUM 

will generate 
A9 07 

The decimal number "7" is terminated 
by the character "A". The comment in 
this case is: 

A GET NUM 

If the user wishes to specify the 
hex location 7A« he must use *7A. 



-17- 



ERROR DESCRIPTION 

When an error occurs the tystcai will print out: 

ERROR- XX Cfli«ss4g«] 

Uh«r« XX r«pr«s«nt« an arror nuiibar. Whan th* Assamblar finds 
■ora than 1 arror in a lina> up to 3 error numbars will ba listad. 
Moat ERRORS will produca a massaga (siaiilar to thoso balow). 

ERROR NUMBERS 

1 - MEMORY FULL 

All available mamoru has baan usad. If issued from Editor< 
no fliora stataeients can be entered. If issued by the 
Asseflibler« no more labels can ba defined. 

2 - INVALID DELETE RANGE 

The first number specified in a delete range does not 
exist. 

3 - DEBUG ASSEMBLER ADDRESS ERROR 

The origin address on an input line to the Debug Assembler 
is incorrectly specified. 

4 - BLANK REQUIRED AFTER LINE NUMBER 

The Assembler expects the first character after a line number 
to be a blank. The first character was ignored. 

5 - UNDEFINED REFERENCE 

Assembler has encountered an undefined label. 

6 - ASSEMBLER SYNTAX ERROR 

7 - DUPLICATE LABEL 

The Assembler has encountered a label that is already defined. 

8 - BUFFER OVERFLOW 

An internal buffer is full. Try making the source code 
shorter. 

9 - EQUATE HAS NO LABEL 

An equate («) must have a label. 

10 - VALUE OF EXPRESSION > 299 

The value of an expression was greater than 299 but a one 
byte value was required. 
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11 - NULL STRING 

A null string is invalid in .BYTE 

12 - INVALID ADDRESS OR ADDRESS TYPE 

An invalid address type uas spscifisd for thm mnemonic. 

13 - PHASE ERROR 

The address generated for a label in pass 2 of the 
Assembler is different from the address generated by 
pass 1. Other errors can also cause this error to be 
generated. 

14 - UNDEFINED/FORWARD REFERENCE FOR *- (ORG) 

The operand for the *■ directive must already be defined 
when the directive is encountered. A foruiard reference on 
an *■ directive is invalid. 

Example: 1000 *>>ABC 

2000 ABC > tlOOO 
Will produce this error. 

15 - LINE TOO LONG 

The input line is too long. (This error results 
when there are too many distinct items on a line for the 
syntax processor to handle. ) Break the input line into 
multiple lines. 

16 - INVALID INPUT LINE 

The Assembler received a line that does not start with a 
valid line number. 

17 - LINE NUMBER TOO BIG 

The line number on an Editor input line is too big. 
(greater than 69939). 

19 - NO ORIGIN (*-) SPECIFIED 

Either no origin (*«) was given or it was specified as 0. 
This error will cause the assembly to terminate. 

20 - OVERFLOW ON NUM OR REN 



On NUN or REN command the line number generated went over 
69939. If aeN caused this error* the line numbers are now 
invalid. Issuing a valid HEH command will correct the problem. 

21 - NESTED INCLUDE INVALID 

An INCLUDEd file can not contain a . INCLUDE directive. 
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NOTES 



LOMEM/HIMEM: 

A default low mvfliory address is set when thm systvm is booted up. 
EASMD does NOT eutosMt ical ly reset this value. 

If a prograei (for example, a device handler) sets loaeei and then 
EASra) is entered* this address remains unchanged. 

EASHD does set a default UHIilEM (highest usable memory for EASMD 
tables, including user text) which can be changed by using the 
Change memory comeiand in the Debug monitor. 

ICX:Bs USED: 

No comflMind in the Debug monitor does I/O to a device other than 
the screen or keyboardi therefore. lOCBs 1 through 7 are not used 
by the system itself while in Debug mode. 

Several commands in the Editor however, can do I/O to other devices 
(ENTER. ASM. etc). In these cases, the Editor must use one or 
more lOCBs. (The Editor uses lOCBs 1 through 4). Unpredictable 
things can happen to a file that was allocated to one of these 
lOCBs and never closed. The user who is debugging code that does 
I/O needs to be aware of this fact. 

ALWAYS CLOSE FILES. 

Note that returning to OS/A-*- will ALWAYS cause all files to be 
closed. 

LOAD/SAVE: 

To load and save code for debugging, use the LOAD and SAVE 

command. To return to EASMD after LOADing a file, the user must 
enter RUN followed by the coldstart or warmstart address (see 
memory map). This will work if the user's code did not overlay 
any memory used by EASMD. 



The Editor /Assembler/Debug (EASMD) uses positive integers and hex 
numbers, but it uses a Floating Point package for ASCII to integer 
conversion. This can give some unexpected results. 



NUMBERS: 



Example: 



LDA 



•6. 7 



produces 



A9 07 



Example: 



100. 



100. i 



99. 9 



entered as line 
the line number 



numbers each produces 

100. 
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BASIC: 

Th» Editor c«n hm us«d to craat* and adit OSS BASIC A-«- programs. Of 
coursci the u««r «ust t«k« car* of changing lina numbers in OOTO* 
OOSUBi ate. whanavvr RENumbar is used. 
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NENQRY NAP 



Th« following «r« so«« aomory addrvssos utod by EASMD which «ay 
bo of intorost to tho user. All addrossos art givtn in hox. 



sizo of RAM 



32K 



40K 



4aK 



zoro page froo for user 
usor high aooiory (UHIMEM) 
Coldstart 
Uar«st«rt 



BO-CF 
0498 
5700 
5703 



BO-CF 
0498 
7700 
7703 



BO-CF 
0498 
9700 
9703 
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EDITOR 



SYNTAX SUrWARY 



ASM 

ASM Cttsourc* fil*«(>cc3i C»list fil«spcc3. Cttobjsct fil«spcc3 
BUG 

BYE 
CP 

DEL Ino 

DEL Inol. lno2 

DOS 

ENTER ttfilcspac 

FIND /string/ 

FIND /string/. A 

FIND /string/lnolC. lno23 

FIND /string/lnolC. Ino2], A 

LIST 

LIST •filcspac 

LIST InolC. lno23 

LIST •filcspac. InolC. Ino23 

LOMEM adr 

NEW 

NUM 

NUM slnot incr 

NUM incr 

PRINT 

PRINT ftfilffspsc 

PRINT lnolC.lno23 

PRINT ttf il«sp«c. InoiC. Ino23 

REN slno< incr 

REN incr 

REP /old string/n*«f 

REP /old string /now 

REP /old string/noM 

REP /old string/now 



SIZE 
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str ing/ 
string/, ■CA> 
<Q> 

string/lnolC. lno23 
string/lnolC, lno23. <.A> 

<Q> 



leue 

A trndrK «ss««bl»r cod* (blank required aft«r <) 

C C«drl3< d«t« 

CR <data 

D 

D adrlC.adr23 
DR 

O Cadrl 

L 

L adrlC,«dr23 

n tadr < fsadri f«asr 

S Cadrl 

T Cadr3 

V «dri < «dr2.«dr3 

X 

ASSEMBLER DIRECTIVES 

•BYTE •xpr««sion and/or "itring" list 

. DBYTE expression list 

. END 

• IF oxprossiont label 

. INCLUDE tf ilaspoc 

.OPT option list 

.PACE C"strin8"3 

•TAB oiprossion* oxpression* expression 

.TITLE "string" 

.WORD expression list 

*<■ expression 

■= expression 
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ERROR SUNHARY 

Thi» is « lUMarv of •rror «cs«ag«s produced by th« EASMO program 
For a «or« dotal led doer ip it ion tho sac t ion on ERROR 

DESCRIPTION. 

EASHD ERRORS: 



1 




MPMTID V n H ■ 

ribnuKY rut_L. 








3 




ucBuw HsacnauiiK AuDKfcaS ERROR 


4 










VtntfKir Anew nCrcntm^b 


6 


_ 


ASSEMBLER SVMTAy pnono 


7 




DUPLICATE LABEL 


e 




BUFFER OVERFLOW 


9 




EQUATE HAS NO LABEL 


10 




VALUE OF EXPRESSION > 299 


11 




NULL STRING 


12 




INVALID ADDRESS OR ADDRESS TYPE 


13 




PHASE ERROR 


14 




UNDEFINED/FORWARD REFERENCE FOR ♦» (ORG) 


19 




LINE TOO LONG 


16 




INVALID INPUT LINE 


17 




LINE NUMBER TOO BIG 


19 




NO ORIGIN (*>) SPECIFIED 


20 




OVERFLOW ON NUM OR REN 


21 




NESTED INCLUDE INVALID 
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For tha user conv«ni«nc« a tuMMry of the error ««ss«g«s th«t 
can bm ganaratod bv DOS and passed to EASHD ara includad. 



DOS 


ERRORS: 




DEC 


HEX 


MESSACE 


128 


(80> 


BREAK ABORT 


129 


(81 ) 


FILE ALREADY OPEN 


130 


(82) 


NON EXISTENT DEVICE 


131 


(83) 


FILE OPENED FOR WRITE ONLY 


132 


(84) 


INVALID COI1HAND 


133 


(89) 


DEVICE OR FILE NOT OPEN 


134 


(86) 


INVALID lOCB NUHBER 


139 


(87) 


FILE OPENED FOR READ ONLY 


136 


(88) 


END OF FILE 


138 


(8A) 


DEVICE TIMEOUT 


139 


(SB) 


DEVICE NAK 


144 


(90) 


DEVICE DONE ERROR 


146 


(92) 


FUNCTION NOT IMPLEMENTED 


160 


(AO) 


DRIVE • ERROR 


161 


(Al) 


TOO MANY OPEN FILES (NO SECTOR BUFFER AVAILABLE) 


162 


(A2) 


MEDIUM FULL (NO FREE SECTORS) 


163 


(A3) 


FATAL SYSTEM DATA I/O ERROR 


164 


(A4) 


FILE » MISMATCH 


165 


(A9) 


FILE NAME ERROR 


166 


(A6) 


POINT DATA LENGTH ERROR 


167 


(A7) 


FILE PROTECTED 


168 


(AS) 


COMMAND INVALID (SPECIAL OPERATION CODE) 


169 


(A9) 


DIRECTORY FULL 


170 


(AA) 


FILE NOT FOUND 


171 


(AB) 


POINT INVALID 
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